home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 4 / CU Amiga Magazine's Super CD-ROM 04 (1996)(EMAP Images)(GB)(Track 1 of 3)[!][issue 1996-11].iso / support / parnet / docfiles / parbench.doc < prev    next >
Text File  |  1995-05-13  |  14KB  |  331 lines
  1.  *****************************************************************
  2.  *        ParBench ParNET Installation Scripts Disk              *
  3.  *                         V3.1                     *
  4.  *                  ©1992 By Vernon Graner             *       
  5.  *****************************************************************
  6.  
  7.  
  8.                         ***Background***
  9.  
  10. This disk was born out of frustration when I tried to install what
  11. appeared to be a rather simple program from Software Distillery.
  12.  
  13.     After wrestling with the DOCs for a couple of hours and FINALLY 
  14. getting all the MountLists and C: commands in the right places, I had 
  15. a working ParNET installed. I then decided that for some users, the
  16. install would be almost impossible without some form of simple
  17. installation Icon, so I built one, then another, and so on until I had
  18. a complete collection of ParNET installation scripts.
  19.  
  20.                     *** Using This Disk ***
  21.  
  22.     The first step in creating a working ParNET is to READ THE
  23. SOFTWARE DISTILLERY DOCS on how to build the special parallel cable
  24. that is used to connect the two Amigas in the NET. After doing so, TURN
  25. THE POWER OFF ON BOTH AMIGAS and then connect the cable between them.
  26. (Rumor has it that Software Distillery has a financial interest in the
  27. 8520 VIA Chip factory, but *I* don't believe it! ;) ) After switching on both
  28. Amigas, all that's left to do is run the scripts on this disk.
  29.  
  30.                 **** 2 Amigas With Hard Disks ****
  31.                **** Installation  Step by Step ****
  32.  
  33. To get a working PARBench between the 2 Amiga with hard drives:
  34.  
  35. 1. TURN THE POWER OFF on BOTH MACHINES, then connect the special
  36.     ParNET Cable between the 2 parallel ports.
  37.  
  38. 2. Boot both machines normally
  39.  
  40. 3. Choose one Amiga to be designated the 'Host' and one Amiga
  41.    to be designated 'Client'  (It makes no difference which ones)
  42.  
  43. 4. Insert the PARBench disk into the 'Host' Amiga.
  44.  
  45. 5. Doubleclick the 'ParNET.Install' icon.
  46.  
  47. 6. When the script is finished, remove the PARBench disk and
  48.    place it in the 'Client' Amiga .
  49.  
  50. 7. Doubleclick the 'ParNET.Install' icon.
  51.  
  52.     ParNET is now installed and ready to run on both machines.
  53. Now all you need to do is start ParNET by opening the ParNET drawer 
  54. on your SYS: partition on the HOST machine and double clicking on the
  55. 'Boot.Host' icon. Do the same with the client machine with its 'Boot.Client' 
  56. icon. If all is working properly, the two machines should post drive lists 
  57. for each other, then negotiate a connection. At this point, a disk icon
  58. labled NET should appear on both machines. If this is not the case, then 
  59. check the trouble-shooting guide at the end of this document.
  60.  
  61.     The next step is to edit a file that PARBench has created called
  62. 'PARNet-DriveList' located in the S: directory of both machines. Due to a 
  63. limitation of ParNET, no drives will be visible on either machine until
  64. they have been 'Touched' or CD'd to. This file will be copied to the RAM 
  65. disk so that on starting PARNET each Amiga will know what drives are to
  66. be 'touched' on the remote Amiga. The list has a series of drives in it
  67. and you should uncomment the drives you expect to be available at all 
  68. times. To uncomment, simply remove the semi-colon before the name of
  69. each drive available on your system. Since there is no way to be certain 
  70. that a disk will be in the drive at the time of boot, Floppy Drives are 
  71. usually commented out.
  72.  
  73.     The last step in the installation is to use the 'Add.Icons'
  74. script to make the special 'Node.rinfo' files that ParNET requires for icons.
  75. To install icons on the drives you want to appear on the remote machine, 
  76. single-click the 'Add.Icons' icon, then hold down the shift key and
  77. double-click on the drive you would like an icon copied to. For example,
  78. I usually would add an icon to the sys: partition of my A3000 by clicking
  79. once on the 'Add.Icons' icon then hold the shift key and click twice on
  80. the WB_2.x icon on the workbench. The script will check for the existence 
  81. of a previously installed icon and ask for permission to overwrite if one
  82. is found.
  83.  
  84.  
  85.                      *** Other possible setups: ***
  86.                 *** When only 1 Amiga has a Hard Disk ***
  87.  
  88.  
  89.     In this example setup, you could use an A2000HD as a host and an
  90. A500 with no hard drive as a Client. To do so, you would connect the
  91. cable, boot the A2000HD normally and then insert the ParBENCH disk into
  92. the A2000HD's drive. Now you would click the Install.Host Icon and 
  93. answer the questions, and then wait for it to finish. Then you would insert
  94. the ParBENCH disk into the A500 and reboot it. While the A500 is rebooting,
  95. open the ParNET drawer on the A2000HD's SYS: partition and click the
  96. Boot.Host icon.
  97.  
  98.      In a moment, the A500 will boot from the ParBENCH disk. You would then
  99. open the A500's floppy drive, open the ParNET Drawer and double click the 
  100. Boot.Client script. A Connection should be established between the 2 machines. 
  101. By using the provided DefSysDisk icon, you can tell the A500 to utilize the
  102. A2000HD's hard drive as the A500's system partition. To use DefSysDisk, first
  103. double click the Network icon on the A500's screen and look for the SYS icon. 
  104. Next single click the DefSysDisk icon, press and hold the shift key and then 
  105. double click the SYS icon in the Network drawer. That icon will now become 
  106. the system partition for the A500. The A500 may then use the Host A2000HD, 
  107. its workbench or even its Startup-sequence. If you like, you can create a
  108. script in the S: directory of the Host Machine (A2000HD in this case) for the
  109. client machine to find and boot from.
  110.  
  111.     The only case where this would not work would be if the Host
  112. machine uses Version 2.04 of Workbench and if the Client machine used V1.3
  113. Kickstart and had no hard drive of its own. In this case using the SYS:
  114. partition on the Host machine will fail because WB2.04 commands REQUIRE a
  115. 2.04 kickstart to function.
  116.  
  117.  
  118.                      *** Other possible setups: ***
  119.            *** Using a CDTV as an Intelligent CDROM Drive ***
  120.  
  121.     The ParBENCH software package may be used to connect a CDTV to
  122. an Amiga as a CDROM drive By using the HyperMedia Concepts Fred Fish Collection
  123. on CDROM. Here are the step by step instructions:
  124.  
  125. 1. TURN THE POWER OFF on BOTH MACHINES, then connect the special
  126.    ParNET Cable between the 2 parallel ports.
  127.  
  128. 2. Insert the Fred Fish CDROM into a caddy and then into the CDTV.
  129.  
  130. 3. Power up both machines and allow them to boot normally.
  131.  
  132. 4. Insert the PARBench disk into the Amiga.
  133.  
  134. 5. Doubleclick the 'ParNET.Install' icon.
  135.  
  136. 6. When the script is finished, remove the PARBench disk.
  137.  
  138. 7. Open the Workbench partition on the Amiga and then open the ParNET drawer.
  139.  
  140. 8. Double click the CDTV.Connect icon.
  141.  
  142. 9. Use the remote on the CDTV to open the Fred Fish Collection icon.
  143.  
  144. 10.Double click the PARNET_SWITCH icon.
  145.  
  146.  
  147. The two machines should negotiate a connection and the network icon should
  148. appear on the Workbench screen of the Amiga. Inside of this icon will be the
  149. the RAM DISK icon as well an icon (shaped like a fish tank) for the CD.
  150.  
  151.  
  152.                   ******* Activating CDTV NETKEYS ********
  153.  
  154.  
  155.  If you don't have a keyboard or mouse for your CDTV or if you just don't have
  156. the room or inclination to clutter your desk with 2 keyboards and/or mice, then
  157. NETKEYs is for you! There are only 2 steps to making your Amiga's keyboard and
  158. mouse operate your CDTV:
  159.  
  160. 1. Open the RAM DISK icon on the CDTV, then locate and double-click
  161.    the "CDTV.NetKeys" Icon.
  162. 2. Open the ParNET Drawer on your Amiga Workbench and double-click
  163.    the "Run.NetKeys" Icon.
  164.  
  165. Now to swap your keyboard/mouse between the Amiga & CDTV hold the left Amiga
  166. key and then press the letter"P". That's all there is to it! (Lots easier to
  167. mouse around this way than to futz with that IR Controller eh?)
  168.  
  169.  
  170.                         ******** Conclusion ********
  171.  
  172.  
  173. That about wraps it up for ParBENCH instructions. Any questions can be
  174. directed to me or to Software Distillery as I have included their entire
  175. distribution on this disk.
  176.  
  177.  
  178.  
  179.        Vernon Graner
  180. Regional Product Specialist
  181. Commodore Business Machines
  182.    (512)-288-2515 VOICE
  183.  
  184.  
  185.  
  186.                          *** History of changes ***
  187.  
  188. 1.0 First release
  189.  
  190. 1.1 Fixed Bugs in the Client Install script.
  191.  
  192. 1.2 Changed the script names to more conventional "Host" & "Client"
  193.     from "Server" and Client. Hopefully less Confusing!
  194.  
  195. 1.3-1.9 Small improvements to the scripts including error checking
  196.         syntax and echo commands to inform the user.
  197.  
  198. 2.0 Added remove Icons for people that requested and also fixed bugs
  199.     in protection system to prevent people from removing the ParNET
  200.     from the install disk!!
  201.  
  202. 2.5 A number of changes:
  203.  
  204.     a..Workbench 2.0 drawers used
  205.  
  206.     a..Create a ParNET-Drivelist to
  207.        Mount Icons Automatically.
  208.  
  209.     c..Added a Monitor.NET Icon to Utilize the NetSTAT Command
  210.  
  211.     d..Added an 'Add Icons' Icon to shift-click on new drives
  212.        in order to easily add ParNET Icons to them.
  213.  
  214.     e..Boot a non-hard drive Amiga client
  215.        from a Host Amiga Drive using S:Startup-ParNET
  216.  
  217. 3.0  Added 030 version of the handler for hackers and updated
  218.     Documentation for CBM Release.
  219.  
  220. 3.0a Fixed small bug in the ToolTypes of the documentation icon.
  221.  
  222. 3.1  Another Major change up:
  223.  
  224.     a..Reworked the entire scripting mechanism to utilize Commodore's
  225.        INSTALLER utility. (I (hate) Parens(!))
  226.  
  227.     b..Combined the Install.Host and Install.Client scripts
  228.  
  229.     c..Relocated most of the icons for easier novice use.
  230.  
  231.     d..Created a special Boot icon for connecting to the CDTV and
  232.        the Hypermedia Concepts CDROM
  233.  
  234.     e..Reworked the documentation
  235.  
  236.     f..Added the Source Code to ParNET as dloaded from the Software
  237.            Distillery BBS
  238.  
  239.  
  240.                       **** Known Bugs ****
  241.  
  242.  
  243.  
  244. 1.    "Unknown Command Key "" "
  245.     Sometimes when a system is using ARP instead of the standard AmigaDOS,
  246.     this error is returned. Solution? Don't use ARP! :>
  247.  
  248. 2.    "Could not get information for
  249.     object not found"
  250.     When a network is established between the CDTV and an Amiga equipped
  251.     with AmigaDOS V2.0-2.1, the networked devices will not respond to a DIR nor
  252.     will they respond to a LIST command. A Public Domain command like LS
  253.     works well in place of the AmigaDOS command. (The PD LS Command
  254.     is supplied in the C: directory of this disk.)
  255.  
  256. 3.    "CDTV Reboots when I eject my CD"
  257.     Unfortunatly, whenever you boot the CDTV from a CDROM, ejecting
  258.     that disk will cause the machine to reset. This is a "Feature"
  259.     Of the CDTV Operating system and not related to ParNET. The only
  260.     solution I have found thus far is to boot the CDTV from a floppy
  261.     disk (this one is a good choice!) and THEN change out CDROMs at
  262.     will. At this time I know of no other way. :(
  263.  
  264.  
  265. PS: LEGAL NOTICE- *I* am not responsible for you blowing up your Amiga,
  266. or your getting divorced by spending too much time playing with ParNET
  267. or anything else like that! I made these scripts to be a service to other
  268. ParNET'ers and that's the end of it. No Guarantees. Void where Prohibited.
  269. All rights deserved. Oh Yeah, the scripts ARE Copyrighted so don't rip
  270. um'... just distribute um! (And DON'T charge people for um ok? Thanx.)
  271. Also, special thanks to Don Pope for bug fixes and Ben Owen of Creative
  272. Imagery for some cool icons! Also, an extra special thanks to John DiLullo.
  273.  
  274.  
  275.  
  276.                   **** Troubleshooting Guide: ****
  277.  
  278. Here are a few things that seem to crop up:
  279.  
  280. Problem:                                Solution:
  281. -------------------------------------------------------------------------------
  282. INSERT VOLUME PARBENCH IN ANY DRIVE    --------Make sure the floppy disk
  283.                         containing the ParBENCH
  284.                         scripts is labeled PARBENCH
  285.                         As all the scripts make
  286.                         reference to this name!
  287.  
  288. Unknown Command '.KEY'            --------Looks like you have ARP
  289.                         installed. I don't know a
  290.                         work around for this one
  291.                         'cept DON'T USE ARP. :>
  292.  
  293. INSERT VOLUME NET: IN ANY DRIVE        --------The ParNET install most
  294.                         likely could not find all
  295.                         the files needed. Try a
  296.                         Remove.NET and then re-
  297.                         install.
  298.  
  299. Could not get information for           --------Use the PD command LS located
  300. object not found                                in the C: directory in place
  301.                                                 of the AmigaDOS DIR or LIST.
  302. -------------------------------------------------------------------------------
  303.  
  304. I CAN'T MAKE IT WORK!
  305.  
  306. In my experience, the most common reason for a ParNET to fail is an
  307. incorrectly assembled cable or a blown 8520 chip.
  308.  
  309. The 8520 chip (versatile interface adaptor or VIA) is VERY fragile. If you
  310. plug the cable in with the power on or run the cable thru an A/B box that
  311. is make-before-break or if you plug in an extremely long parnet cable that
  312. has been coiled up on a wool rug in the fall, the 8520 chip may blow up.
  313. If it does, your printer will most likely also cease to function when
  314. connected to that port.
  315.  
  316. The Amiga has two 8520 chips that control floppy drive access, printing,
  317. mouse, joystick and other things. The bad news is that it has very little
  318. protection built in and will rarely survive even one "oops". The good news
  319. is that most of the time it is a socketed chip and should be replaceable
  320. for less than $50 (alot cheaper if you do it yourself). I have managed to
  321. destroy about four of them in the time I have been ParNETing (about 2 years now)
  322. and most of them were from silly mistakes, like a cable built wrong or
  323. connecting the cable with the power on. One way to diagnose the 8520 is to
  324. swap the two of them inside your machine. If ParNET starts to work but your
  325. mouse or floppy quits, then you've got a blown 8520.
  326.  
  327. If you still have questions, you can call me voice and I'll be happy to help
  328. you set up a ParNET of your own. (If you are calling long distance and I'm not
  329. here, just leave a message and I'll call you back but I'll have to call
  330. collect!)
  331.